home *** CD-ROM | disk | FTP | other *** search
/ SGI MineSet 2.5 / SGI MineSet 2.5.iso / dist / imgtools.idb / usr / share / catman / u_man / cat1 / imgcopy.z / imgcopy
Text File  |  1998-05-12  |  12KB  |  265 lines
  1.  
  2.  
  3.  
  4. IIIIMMMMGGGGCCCCOOOOPPPPYYYY((((1111))))                                                          IIIIMMMMGGGGCCCCOOOOPPPPYYYY((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      imgcopy - copy and convert image file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      iiiimmmmggggccccooooppppyyyy [----ffffformat] [----ttttdata_type] [----OOOOorder] [----ppppw,h,z,c] [----oooow,h,z,c]
  13.              [----ssssw,h,z,c] [----ccccorientation] [----CCCCcolor_model] [----PPPPcompression_type]
  14.              [----qqqqcompression_quality] [----mmmmminimum_value] [----MMMMmaximum_value] [----hhhh]
  15.              [----DDDD] [----nnnn#colors] [----aaaa] infile[::::index][####format][%%%%format_args]
  16.              outfile[####format][%%%%format_args]
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _i_m_g_c_o_p_y allows image files with formats supported by the ImageVision
  20.      Library to be copied and converted to other supported formats.  The
  21.      following command line options are allowed:
  22.  
  23.      ----ffff_f_o_r_m_a_t
  24.           Specifies the file format to convert to.  By default the output
  25.           image file format is based on the file name extension.  If the
  26.           extension is not of a known type, then the default file format will
  27.           be used (usually TIFF).  The supported file formats depend on what
  28.           ImageVision file formats have been installed; if an unknown format
  29.           is given the valid options will be listed.
  30.  
  31.      ----tttt_d_a_t_a__t_y_p_e
  32.           Specifies the data type to convert to.  By default the output image
  33.           file will use the input image's data type, if possible.  The data
  34.           type may be one of: bbbbiiiitttt, cccchhhhaaaarrrr, uuuucccchhhhaaaarrrr, sssshhhhoooorrrrtttt, uuuusssshhhhoooorrrrtttt, lllloooonnnngggg, uuuulllloooonnnngggg,
  35.           ffffllllooooaaaatttt and ddddoooouuuubbbblllleeee.
  36.  
  37.      ----OOOO_o_r_d_e_r
  38.           Specifies the ordering of dimensions of the created image.  May be
  39.           one of:  iiiinnnntttteeeerrrrlllleeeeaaaavvvveeeedddd (bands, samples, lines), sssseeeeqqqquuuueeeennnnttttiiiiaaaallll (samples,
  40.           bands, lines) or sssseeeeppppaaaarrrraaaatttteeee (samples, lines, bands).  By default the
  41.           output image file will have the same ordering as the input if the
  42.           selected image file format supports it.
  43.  
  44.      ----pppp_w,_h,_z,_c
  45.           Specifies the page size of the created image.  A default page size
  46.           will be computed if none is given.
  47.  
  48.      ----oooo_w,_h,_z,_c
  49.           Specifies the origin of a subregion to be copied from the input
  50.           image.  By default the entire image will be copied.
  51.  
  52.      ----ssss_w,_h,_z,_c
  53.           Specifies the size of a subregion to be copied from the input image.
  54.           By default the entire image will be copied.
  55.  
  56.      ----cccc_o_r_i_e_n_t_a_t_i_o_n
  57.           Specifies the orientation to convert to.  By default the output
  58.           image file will use the input image's orientation, if possible.  The
  59.           orientation may be one of: ttttllll, bbbbllll, ttttrrrr, bbbbrrrr, lllltttt, llllbbbb, rrrrtttt and rrrrbbbb.  Where
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IIIIMMMMGGGGCCCCOOOOPPPPYYYY((((1111))))                                                          IIIIMMMMGGGGCCCCOOOOPPPPYYYY((((1111))))
  71.  
  72.  
  73.  
  74.           llll is left, rrrr is right, tttt is top and bbbb is bottom.
  75.  
  76.      ----CCCC_c_o_l_o_r__m_o_d_e_l
  77.           Specifies the color model to convert to.  By default the output
  78.           image file will use the input image's color model, if possible.  The
  79.           color model may be one of: rrrrggggbbbb, aaaabbbbggggrrrr, ggggrrrreeeeyyyy, nnnneeeeggggaaaattttiiiivvvveeee, ppppaaaalllleeeetttttttteeee, hhhhssssvvvv,
  80.           ccccmmmmyyyy and ccccmmmmyyyykkkk.
  81.  
  82.      ----PPPP_c_o_m_p_r_e_s_s_s_i_o_n__t_y_p_e
  83.           Specifies the type of compression to use in the output image file.
  84.           The compression may be one of:  nnnnoooonnnneeee, ffffaaaaxxxx3333, ffffaaaaxxxx4444, llllzzzzwwww, mmmmaaaaccccrrrrlllleeee,
  85.           ssssggggiiiirrrrlllleeee, jjjjppppeeeegggg or zzzziiiipppp
  86.  
  87.      ----qqqq_c_o_m_p_r_e_s_s_s_i_o_n__q_u_a_l_i_t_y
  88.           Specifies the quality of compression to use in the output image
  89.           file.  The value ranges from 0 (worst) to 100 (best). The default is
  90.           75.  Currently this is only meaninful when saving to a JFIF (.jpg)
  91.           file.
  92.  
  93.      ----mmmm_m_i_n_i_m_u_m__v_a_l_u_e
  94.           Specifies the minimum value to tag the output image with. No scaling
  95.           is implied; this option is mainly used to override input images with
  96.           invalid minimum values.  By default the output image file will use
  97.           the input image's minimum value.  This option overrides the -h
  98.           option.
  99.  
  100.      ----MMMM_m_a_x_i_m_u_m__v_a_l_u_e
  101.           Specifies the maximum value to tag the output image with. No scaling
  102.           is implied; this option is mainly used to override input images with
  103.           invalid maximum values.  By default the output image file will use
  104.           the input image's maximum value.  This option overrides the -h
  105.           option.
  106.  
  107.      ----hhhh   Specifies that the input image is to be histogrammed in order to
  108.           determine the minimum and maximum values to tag the output image
  109.           with. No scaling is implied; this option is mainly used to override
  110.           input images with invalid minimum and maximum values.  By default
  111.           the output image file will use the input image's minimum and maximum
  112.           values.  This option overrides the -m and -M options.
  113.  
  114.      ----DDDD   Specifies that ordererd dithering should be used instead of Floyd-
  115.           Steinberg dithering when converting to images with a palette type
  116.           color model.
  117.  
  118.      ----nnnn#_c_o_l_o_r_s
  119.           When doing Floyd-Steinberg dithering, the target number of entries
  120.           in the color map to be computes (using Heckbert's median-cut
  121.           algorithm).
  122.  
  123.      ----aaaa   Specifies that the input image is to be appended as a sub-image to
  124.           the output image. Only certain formats (like TIFF and GIF) support
  125.           the appending of sub-images.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. IIIIMMMMGGGGCCCCOOOOPPPPYYYY((((1111))))                                                          IIIIMMMMGGGGCCCCOOOOPPPPYYYY((((1111))))
  137.  
  138.  
  139.  
  140.      The _w, _h, _z and _c values used with the ----pppp, ----ssss and ----oooo options refer to the
  141.      width, height, depth and component dimensions of the image.
  142.  
  143.      The optional index after the input file name is useful on multi-
  144.      resolution images like Photo CD, to select the desired sub-image.  You
  145.      can use imginfo to get a complete list of all sub-images for a given
  146.      file.
  147.  
  148.      The optional format following a file name can be used to specify an
  149.      output file format or to indicate that an image is in raw format.  The
  150.      format_args are format specific.
  151.  
  152. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  153.      To convert an image to the classic SGI format use a command like:
  154.  
  155.           iiiimmmmggggccccooooppppyyyy ssssoooommmmeeeeiiiimmmmaaaaggggeeee....ssssoooommmmeeeeffffoooorrrrmmmmaaaatttt oooouuuuttttiiiimmmmaaaaggggeeee....rrrrggggbbbb
  156.  
  157.      To pick out a 100x100 region starting at (40,50) and write it out as a
  158.      TIFF image file use the command:
  159.  
  160.           iiiimmmmggggccccooooppppyyyy ----ssss 111100000000,,,,111100000000 ----oooo 44440000,,,,55550000 iiiinnnniiiimmmmaaaaggggeeee....rrrrggggbbbb oooouuuuttttiiiimmmmaaaaggggeeee....ttttiiiiffff
  161.  
  162.      To convert an RGB image to greyscale color model use the command:
  163.  
  164.           iiiimmmmggggccccooooppppyyyy ----CCCCggggrrrreeeeyyyy iiiinnnniiiimmmmaaaaggggeeee....rrrrggggbbbb oooouuuuttttiiiimmmmaaaaggggeeee....bbbbwwww
  165.  
  166.      To convert an image to SGI format with no extension on the output file
  167.      name use either command:
  168.  
  169.           iiiimmmmggggccccooooppppyyyy ----ffffssssggggiiii iiiinnnniiiimmmmaaaaggggeeee oooouuuuttttiiiimmmmaaaaggggeeee
  170.  
  171.           iiiimmmmggggccccooooppppyyyy iiiinnnniiiimmmmaaaaggggeeee oooouuuuttttiiiimmmmaaaaggggeeee####ssssggggiiii
  172.  
  173.      To convert the higest resolution sub-image in a Photo CD image to TIFF
  174.      format use the command:
  175.  
  176.           iiiimmmmggggccccooooppppyyyy iiiinnnniiiimmmmaaaaggggeeee....ppppccccdddd::::5555 oooouuuuttttiiiimmmmaaaaggggeeee....ttttiiiiffff
  177.  
  178.      To convert a raw file (with no header information) containing a
  179.      luminance, unsigned char, 512 by 512 image to TIFF format:
  180.  
  181.           iiiimmmmggggccccooooppppyyyy iiiinnnnffffiiiilllleeee####rrrraaaawwww%%%%ssssiiiizzzzeeee====555511112222,,,,555511112222%%%%ccccoooolllloooorrrrmmmmooooddddeeeellll====lllluuuummmmiiiinnnnaaaannnncccceeee oooouuuuttttiiiimmmmaaaaggggeeee....ttttiiiiffff
  182.  
  183. NNNNOOOOTTTTEEEESSSS
  184.      The supported image file formats depend on which file formats are
  185.      currently installed.  The installed formats can be listed with the
  186.      _i_m_g_f_o_r_m_a_t_s(1) command.
  187.  
  188.      The SGI file format ignores most data formatting options; it determines
  189.      what it can support and creates a compatible file as best it can.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. IIIIMMMMGGGGCCCCOOOOPPPPYYYY((((1111))))                                                          IIIIMMMMGGGGCCCCOOOOPPPPYYYY((((1111))))
  203.  
  204.  
  205.  
  206. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  207.      imgview(1), imginfo(1), imgworks(1), imgformats(1)
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.